home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / dev / raid.man < prev    next >
Encoding:
Text File  |  1992-09-04  |  4.2 KB  |  119 lines
  1. '\" Copyright 1990 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/man/dev/RCS/raid.man,v 1.2 92/09/04 16:19:44 eklee Exp Locker: eklee $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS RAID dev
  13. .BS
  14. '\" Note:  do not modify the .SH NAME line immediately below!
  15. .SH NAME
  16. raid \- Devices used to send ioctl's to RAID devices.
  17. .SH SYNOPSIS
  18. \fB#include <dev/raid.h>\fR
  19. .BE
  20.  
  21. .SH OVERVIEW
  22. .PP
  23. This document describes the configuration and management of raid devices.
  24.  
  25. .SH THE RAID CONFIGURATION FILE
  26. .PP
  27. An example RAID configuration file is as follows:
  28. .DS
  29. .in -12
  30. #                                              R L S N
  31. #              512B        32KB      323MB
  32. #numRow numCol logSectSize sectPerSU SUPerDisk parityConfig logDev(d,u,offset)
  33. 1       4      9           64        9859      L            516 5128 0
  34. 516    7176
  35. 516    7192
  36. 516    7208
  37. 516    7224
  38. .DE
  39.  
  40. Lines starting with '#' are considereded comments.  Comments can only occure
  41. at the BEGINNING of the configuration file.
  42. .IP numRow, numCol
  43. The number of rows and columns of disks in the disk array.  Parity is computed
  44. accross the disks in each row.
  45. .IP logSectSize
  46. The log base 2 of the sector size.  A 9 => 2^9 = 512 byte sectors.
  47. .IP sectPerSU
  48. The number of sectors per stripe unit.  The stripe unit is the amount of data
  49. placed on a given disk before data is placed on the next disk.
  50. .IP SUPerDisk
  51. The number of stripe units per disk.
  52. .IP parityConfig
  53. The parity configuration to use.  L => left-symmetric (the best all-around
  54. choice), R => right-symmetric, N => RAID level 4 placement and S => do not
  55. compute parity; i.e., only data striping.
  56. .IP logDev
  57. The type, unit and device offset for the log disk.  By specifying different
  58. offsets, the same disk can be used as the log for several disk arrays.
  59. If the parity configuration is S, logging is not neccessary and this field
  60. should be set to -1 -1 -1 instead of 516 5128 0 in the above example.
  61. .LP
  62. The rest of the file contains a list of the type and unit number of each disk
  63. in the disk array.
  64.  
  65. .SH ADDING A NEW RAID DEVICE
  66.  
  67. .DS
  68. .in -12
  69. Create a new raid device ($x = new raid device number):
  70. --  If necessary, create:
  71.         fsmakedev -d 10 -u $x /dev/raid$x
  72.         fsmakedev -d 10 -u $x /dev/raid${x}a
  73. --  Create raid configuration file /boot/cmds/RAID$x.config.
  74. --  Issue IOC's to configure new device:
  75.     If parityConfig == 'S' (i.e. no parity, only data striping)
  76.         /boot/cmds/raidioc /dev/raid$x reconfig /boot/cmds/RAID$x.config
  77.     else
  78.         /boot/cmds/raidioc /dev/raid$x reconfig /boot/cmds/RAID$x.config
  79.         /boot/cmds/raidioc /dev/raid$x savestate
  80.         /boot/cmds/raidioc /dev/raid$x hardinit 0 -1
  81.         /boot/cmds/raidioc /dev/raid$x enablelog
  82.         /boot/cmds/raidioc /dev/raid$x unlock
  83.     endif
  84. --  Add commands to /hosts/<machine name>/bootcmds to restore existing
  85.     raid device on system boots.
  86.     If parityConfig == 'S' (i.e. no parity, only data striping)
  87.         /boot/cmds/raidioc /dev/raid$x reconfig /boot/cmds/RAID$x.config
  88.     else
  89.         /boot/cmds/raidioc /dev/raid$x restorestate <logDev(d,u,offset)> && \
  90.         /boot/cmds/raidioc /dev/raid$x enablelog                         && \
  91.         /boot/cmds/raidioc /dev/raid$x unlock
  92.     endif
  93. --  Add new device to ~eklee/bin/paritycheckraid if automatic periodic
  94.     parity checks are desired.
  95. .DE
  96.  
  97. .SH ADDING A NEW RAID LFS FILE SYSTEM
  98.  
  99. .DS
  100. .in -12
  101. --  Find out numSector and dataBytesPerStripe (printed to /dev/syslog).
  102.         /boot/cmds/raidioc /dev/raid$x print
  103. --  labeldisk -w /dev/raid$x            # use numSector info here
  104. --  mklfs -segAlignment <dataBytesPerStripe> /dev/raid0
  105. --  If necessary create:
  106.         cd /
  107.         ln -r /r$x
  108. --  Mount file system:
  109.         prefix -M /dev/raid$x -l /r$x
  110. --  Add commands to /hosts/<machine name>/bootcmds to automatically
  111.     export file system.
  112.         prefix -M /dev/raid$x -l /r$x
  113. .DE
  114.  
  115. .SH SEE ALSO
  116.  
  117. .SH KEYWORDS
  118. raid command, raid device
  119.